home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / csyr.z / csyr
Encoding:
Text File  |  1998-10-30  |  3.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCSSSSYYYYRRRR((((3333FFFF))))                                                              CCCCSSSSYYYYRRRR((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CSYR - perform the symmetric rank 1 operation   A := alpha*x*( x' ) + A,
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE CSYR( UPLO, N, ALPHA, X, INCX, A, LDA )
  13.  
  14.          CHARACTER    UPLO
  15.  
  16.          INTEGER      INCX, LDA, N
  17.  
  18.          COMPLEX      ALPHA
  19.  
  20.          COMPLEX      A( LDA, * ), X( * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      CSYR   performs the symmetric rank 1 operation
  24.  
  25.      where alpha is a complex scalar, x is an n element vector and A is an n
  26.      by n symmetric matrix.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      UPLO   - CHARACTER*1
  31.             On entry, UPLO specifies whether the upper or lower triangular
  32.             part of the array A is to be referenced as follows:
  33.  
  34.             UPLO = 'U' or 'u'   Only the upper triangular part of A is to be
  35.             referenced.
  36.  
  37.             UPLO = 'L' or 'l'   Only the lower triangular part of A is to be
  38.             referenced.
  39.  
  40.             Unchanged on exit.
  41.  
  42.      N      - INTEGER
  43.             On entry, N specifies the order of the matrix A.  N must be at
  44.             least zero.  Unchanged on exit.
  45.  
  46.      ALPHA  - COMPLEX
  47.             On entry, ALPHA specifies the scalar alpha.  Unchanged on exit.
  48.  
  49.      X      - COMPLEX array, dimension at least
  50.             ( 1 + ( N - 1 )*abs( INCX ) ).  Before entry, the incremented
  51.             array X must contain the N- element vector x.  Unchanged on exit.
  52.  
  53.      INCX   - INTEGER
  54.             On entry, INCX specifies the increment for the elements of X. INCX
  55.             must not be zero.  Unchanged on exit.
  56.  
  57.      A      - COMPLEX array, dimension ( LDA, N )
  58.             Before entry, with  UPLO = 'U' or 'u', the leading n by n upper
  59.             triangular part of the array A must contain the upper triangular
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCSSSSYYYYRRRR((((3333FFFF))))                                                              CCCCSSSSYYYYRRRR((((3333FFFF))))
  71.  
  72.  
  73.  
  74.             part of the symmetric matrix and the strictly lower triangular
  75.             part of A is not referenced. On exit, the upper triangular part of
  76.             the array A is overwritten by the upper triangular part of the
  77.             updated matrix.  Before entry, with UPLO = 'L' or 'l', the leading
  78.             n by n lower triangular part of the array A must contain the lower
  79.             triangular part of the symmetric matrix and the strictly upper
  80.             triangular part of A is not referenced. On exit, the lower
  81.             triangular part of the array A is overwritten by the lower
  82.             triangular part of the updated matrix.
  83.  
  84.      LDA    - INTEGER
  85.             On entry, LDA specifies the first dimension of A as declared in
  86.             the calling (sub) program. LDA must be at least max( 1, N ).
  87.             Unchanged on exit.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.